package cn.iocoder.lw.module.core.service.device;

import java.util.List;

import cn.iocoder.lw.framework.common.pojo.PageResult;
import cn.iocoder.lw.module.core.controller.admin.device.vo.*;
import jakarta.validation.Valid;


/**
 * 核心设备 Service 接口
 *
 * @author Lw源码
 */
public interface CoreDeviceService {

    /**
     * 创建设备
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Long createDevice(@Valid CoreDeviceSaveReqVO createReqVO);

    /**
     * 更新设备
     *
     * @param updateReqVO 更新信息
     */
    void updateDevice(@Valid CoreDeviceSaveReqVO updateReqVO);

    /**
     * 删除设备
     *
     * @param id 编号
     */
    void deleteDevice(Long id);

    /**
     * 获得设备
     *
     * @param id 编号
     * @return 设备
     */
    CoreDeviceRespVO getDevice(Long id);

    /**
     * 获得设备分页
     *
     * @param pageReqVO 分页查询
     * @return 设备分页
     */
    PageResult<CoreDeviceRespVO> getDevicePage(CoreDevicePageReqVO pageReqVO);

    /**
     * 获得设备列表, 用于 Excel 导出
     *
     * @param pageReqVO 分页查询
     * @return 设备列表
     */
    PageResult<CoreDeviceImportExcelVO> getDeviceList(CoreDevicePageReqVO pageReqVO);

    /**
     * 校验设备是否存在
     *
     * @param id 编号
     */
    void validateDeviceExists(Long id);

    /**
     * 根据项目编号获取设备列表
     *
     * @param projectId 项目编号
     * @return 设备列表
     */
    List<CoreDeviceRespVO> getDeviceListByProjectId(Long projectId);

    /**
     * 根据项目ID和设备状态统计设备数量
     *
     * @param projectId 项目编号
     * @param status 设备状态
     * @return 设备数量
     */
    long countByProjectIdAndStatus(Long projectId, Integer status);

}